home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / admin / tidy-1.000 / tidy-1 / tidy-1.0 / README < prev    next >
Encoding:
Text File  |  1996-03-26  |  2.9 KB  |  71 lines
  1. Tidy README
  2. ===========
  3.  
  4. tidy - Tidy up log file(s) created by syslogd and do statistics on it
  5.  
  6. Version: 1.0 / Release Date March 12, 1996
  7.                Patchlevel 1 / March 14, 1996
  8.  
  9. Tidy cleans up the log file(s) created by the syslogd daemon. For a system
  10. operator it is a bothersome job to sort out the interesting (sometimes
  11. alarming) entries from a pile of standard entries. Tidy distinguishes
  12. different services (telnet, finger, etc.) and removes standard entries.
  13. Furthermore tidy tries to extract a remote host from the messages. These
  14. remote hosts are added to a statistics database. The number of contacts
  15. of each service is saved together with the time/date stamp of the last
  16. contact. The statistics can be printed out as simple ASCII or HTML.
  17.  
  18. REQUIREMENTS
  19. ------------
  20. Tidy requires the perl script language interpreter, version 5. It
  21. definitely won't run on V4 pl36 or lower!
  22.  
  23. You must have syslogd running on your system. There is a little tool
  24. (install-test) that does some simple checks to see whether syslogd is
  25. present on your system. If you don't have syslogd, you'll have to get
  26. the source by FTP and install it yourself. You may then have to edit
  27. syslog.conf in order to tell syslogd to log messages from the `mail'
  28. facility to a file. Tidy will process this file. Refer to the man pages
  29. syslogd(8) and syslog.conf(5).
  30.  
  31. Installation
  32. ------------
  33. See the INSTALL file.
  34.  
  35. Features
  36. --------
  37. If your system is on the Internet, there is a number of services that
  38. are offered by your host, e.g. telnet, rlogin, rsh, finger, talk, ftp
  39. and last but not least mail. If your system logger syslogd is set up
  40. correctly, every contact from remote hosts via this services is logged
  41. to a file, referred to as the `log file' in this description.
  42.  
  43. Tidy goes through the log file line by line and eliminates entries that are
  44. `unsuspicious' and adds the remote hosts contained in there to a statistics
  45. file. The action of tidy is controlled by the configuration file tidy.conf.
  46. By default tidy recognizes the services mentioned above, further services
  47. can be added easily.
  48.  
  49. The statistics are printed in ASCII or HTML format with the following options:
  50. - Print time and/or date of last contact in short or long format
  51.   below or besides the number of contacts.
  52. - Print ruler and/or header lines to enhance readability.
  53. - Sort output by host name, by domains or by number of connections of
  54.   a certain service. Alphabetical sorting case sensitive/insensitive.
  55. - Production of different statistics outputs using multiple configuration
  56.   files.
  57.  
  58. Bug reports and suggestions are welcome!
  59.  
  60. SITES
  61. =====
  62. Tidy is maintained at tsx-11.mit.edu:/pub/linux/sources/sbin/tidy-1.0.tar.gz
  63.  
  64. Latest version available from "ftp://saftsack.fs.uni-bayreuth.de/pub/tidy"
  65. See also "http://saftsack.fs.uni-bayreuth.de/~marek/tidy", the official
  66. tidy Home page.
  67.  
  68. Author: Marek Rouchal, University of Bayreuth, Germany
  69.         (marek@saftsack.fs.uni-bayreuth.de)
  70.  
  71.